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When DOS is called, it displays a list of programs 
on the screen. The list is shown below. 


A. DISK O TSE CSO BS 

B. SOS CMffiRfflGB 

C. COPT FILS 

D. DEISTS FXEZ(S) 

E. RENAME FIZZ 

F. DOCK FILE 

G. UNLOCK FILE 

S. WRITE DOS FILE 


T. FORMAT DISK 
J* DGFUOXS DISK 

K. SHARE SAVE 

L. SHAFT LOAD 

M. SDN AT ADDRESS 
S. DEFINE DEVICE 
0. OQELIQfflB FIXE 



1. 



A DISK DIRECTORY 


This selection is used to display the filenames on a Disk 
Drive. 

You must specify Search Spec and List File. Search Spec 
specifies the filespec * • for which you are searching; 

i,.e., D1 for Drive 1, a specific filename, etc. It is 
usi^fally the Drive number where the diskette is located. List 
File stands for the Device where you want the searched filenames 
listed. 
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DISK OPERATING SYSTEM 9/24/79 
COPYRIGHT- 1979 ATARI 


A. 

B. 

C. 

D. 

E. 
P. 
G. 
ff. 


DISK DIRECTORY • 

I. 

FORMAT 

DISK 

RUN CARTRIDGE 

. j: 

DUPLICATE DISK 

COPY FILE 

K. 

BINARY 

SAVE 

DELETE FILE (S) 

L. 

BINARY 

LOAD 

.RENAME FILE 

M. 

RUN AT 

ADDRESS 

LOCK FILE 

N. 

DEFINE 

DEVICE 

UNLOCK FILS 

0. 

DUPLICATE FILE 

WRITE DOS FILE 
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SELECT ITEM 

A rwproHwl —- 

DIRECTO RY — SEARCH SPEC, LIST FUE^ 
f return! --- 


COS 


SXS 064 

i " 


User entry 
DOS response 

User entry. Default values 
of the specifications are 
supplied by DOS. 


i 


no. of sectors in the file 


■ extender 

name of file 

no. of unused sectors. 


SELECT ITEM 
A \ RETURN I 

DIRECTORY—SEARCH SPEC, LIST FILE? 
D2:,P: t RETURN! 

SEL ECT ITEM 
A 1 RETURN I 

DIRE CTORY—SE ARCH SPEC, LIST FILE? 
Pit | Rg.TvP^l 

SEL ECT ITEM 
A 1 return! 

DIRECTORY—SEARCH SPEC,LIST FILE? 
,P: fEETO'SETl 


SELECT ITEM 
A RETURN 

DO*.* RETURN 
f 


* 

All the Drive 2 files are listed 
on the Printer. 


All the Drive 2 files are listed 
on the screeen. 


All the Drive 1 files are listed 
on the Printer. 


All the Drive 1 files that have 

the form DO_._ are listed on 

the screen. 


3 


B RUN CARTRIDGE 


With this selection control is returned to the cartridge 
in the computer (left cartridge slot in the ATARI 800). If 
no cartridge is installed, the message NO CARTRIDGE appears 
on the screen. With the BASIC cartridge installed, the 
message READY appears on the screen. The READY message is 
also produced by pressing RESET." 



C COPY FILE 


This selection is used to copy from one filespec to another. 
The filespecs may not contain wild cards. 


Copying from diskette to Program Recorder 
is not supported, but copying from Program Recorder to diskette 
is (see examples). The option /S signifies a short inter-record 
gap; one of the examples shows this option. 

The option /A signifies append;one of the examples shows 


this option. 



Examples: 


SELECT ITEM 




COPY—FBCM, TO? 
D2:PAYFIII!,Dl:PAYFII2i;.BAS 


RETUPN 


This exanple copies the file 
PA2FTLE in Drive 2 to PAYFILE.BAS 
in Drive 1. 


SETECT ITEM 


m\ 


COPY—FBCM, TO? ______ 

MMH23.BAS, MA3H45.BAS 


This exanple copies the file 
MMH23.B42 to MAIH45.BAS, both 
in Drive 1 (default). 


SELECT HEM 
C fBRTTTHM l 

COPY—FBCM, TO? _ 

C:/S, NAMES.BAS SBETUBN I 


This exanple copies the file that 
is positioned on the Program Recorder, 
ready to be read. The file was recorded 
with a short inter-record gap, making 
it necessary to use the /S option. The 
file is stored in NAMES.BAS in Drive 1 
(default). 


sfi j-tt item 

C ■BBniRM.'.-l 
CDEY—FBCM, TO? 


EtQjtffiMBSTI 
PETES Bglllttfi-i 
PAUL IKETOBnI 
fciBLl 3 


SShffiSS- 


The text entered on the keyboard 
is placed in the file NAMES. 

After a line of text is entered with 
lEETUKNl it may be altered by the screen 
editor, but it will not be altered in the 
file. Terminati on of text entry is 
acocirplished with fCTBL) 3. 


SELECT ITEM 


BBSaWSgl 


COPY—-FBCM, TO? 
E: ,D:NAMES/A J 
MAES' 

JOHN i Ks.7un.g1 
frankT^td«.>j \ 

I CTRLi T 



This exanple is the same as the last one. 
However, in this case the entered names 
are appended to the file NAMES. 

a 
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D DELETE FILE(S) 


This selection is used to delete one or more files. Wild cards 


may be used in the filespecs. 


Verification of deletion is requested by DOS. The option /N 
eliminates the verification step. 


Examples: 


SELECT ITEM In this example the file TEMP. 1ST is 

D \ RETURN! deleted. 

nET-CTE FILE SPEC 

TEMP.1ST \ RETURN I 

TYPE "Y" TO DELETE... 

Dl: TE MP.1ST ? 

Y /RETURN i 
SELECT ITEM 


r 


J3EL33TE FILE SPEC 
SE LECT ITEM 
d 1 return! 
TEMP3/N^ 

SELECT ITEM 




In this example the file TEMP3 
is deleted without the verification step, 
since the option /N was specified. 


sg,ncr ITEM 

D i RETURN I 
DELETE FILE SPEC 
TEMP*.* /N ? RETURN ■ 


* 

In this example all the TEMP files that 

have the form TEM P __ are deleted 

without the verification step, since the 
option /N was specified. 
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E RENAME FILE(S) 


'flvi-s sd.ection is vised to change the naire of one or more files. 
Wild cards may be used in the filespecs. 


Examples: 


CTrrrrT item 

E i RETURN I 


RENAME, GIVE OID NAME. NEW 
NAMES, SURNAMES I RETURN! 


In this example, the file NAMES is 
renamed SURNAMES. 


SELECT ITEM In this exanple, all the .BAS 

E t RETURN! extenders in Drive 2 are changed to 

RENAME, GIVE OLD NAME, NEW .8KB. 

D2:*.BAS,*.8KB 1 RETURN "1 


) 


4 
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F LOCK FH£ 


this selcticn is used bo render a file inaccessible except for reading. 
A locked file can not be written to, appended to or deleted. Hie filespec 
of a file to be locked may contain wildcards. 


A locked file is indicated by an asterisk before its filename in the 
Directory. An attempt to delete a locked file or write to it is 
identified as Error 167. 


Example: 

SELECT ITEM This example lodes the DCS .SYS file. 

F (RETURN I 

WHAT FILE TO LOCK? 

DCS.SYS f RETURNJ 


£ 



G UNLOCK FILE 


This selection is used to unlock a file or files previously 
locked. The filespec of a file to be unlocked may contain wild 
cards. 


Example: 

S E L ECT liiM This example unlocks the file UNCLE. 

G 1 RETURN J 

WHRT FILE TO UNLOCK? 

UNCLE i RETURN 1 




H WRITE DOS FILE 


This selection is used to copy DOS and the File Management System (IMS) 
from RAM to Drive 1. 

Note. This selection is the one intended for writing a new DOS file, 
not selections C or 0, which can not be used to create a bootable 
copy of DOS.SYS unless DOS.SYS is first renamed then copied. 



I FORMAT DISK 


This selection is used to format a diskette. Formatting 
writes a digital pattern on the diskette that allows data to be stored 
and retrieved from the diskette. 


Example: 

SELECT ITEM 

1 ’ RETURN I 

WHI CH DRIVE TO FORMAT? 

2 t RETURN I 

T YPE "Y" TO FORMAT DISK 2 

yI msml 

(FonS-tting takes almost 2 minutes) 

SHECr HIM 

WARMING: Formatting a diskette destroys all the files on the diskette. 
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f J DUPLICATE DISK 

This selection is used to copy one diskette to another. The 
diskette to be copied is in the Source Drive and the copy is in the 
Destination Drive. 

Programs in RAM are destroyed by the duplicating process, 
so DCS displays the retdnder OK TO USE PROGRAM AREA? 

Wien duplicating with one Drive, the available RAM is filled with 
copied files, then the data in RAM is copied to the destination 
diskette. If there is not enough RAM to duplicate the entire diskette 
in one operation, DOS will keep issuing instructions for the insertion 
of diskettes in the correct sequence. 

) 


CAUTION: 


Duplication to a diskette with files erases those files. 


Example: 


S ET .FIT ITEM 
J 1 RETURN 1 

DUP DISK - SOURCE, DEST DRIVES? 
i;2 rRETURN! 

INSERT BOTH DISRS, TXPE RETURN 


In this dbnple, the Drive 1 diskette 
is duplicated in Drive 2. 


(Cursor appears while the diskette is being duplicated, a process that, 
consumes several minutes fir a full diskette.) 


> 
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K BINARY SAVE 


This selection is used to save the contents of memory in a filespec. 
The starting and ending memory locations in hex must be specified. Append 
is accomplished with the /A option. 


Examples: 


SE LECT ITEM 
K \ RETURN i 

SAVE — GIVE PILE, START, END 
D2:BINARY, 5C00,5FFF 1 RETURN’ 


In this example, the contents of locations 
5D00 through 5FFF are saved in the file 
BINARY. Memory locations must be in hex. 


SEE ECT ITEM 
K i ftETURN) 

SAVE —GIVE FILE, START, END 
D2 :BINARY/A, 6200,62CD (REIURnI 


In this example, the contents of locations 
6200 through 62DD are appended to the file 
BINARY. Memory locations must be in hex. 


To make a binary file run automatically, its starting address should bo - ^ 
inserted in locations 2E0 and 2E1 hex (equal to decimal locations 736 and 737) 
For example, the following procedure may be used to convert the file 
BINFILE to one that automatically runs vhen loaded: 


READY 

POKE 736, ST ARTED RETURN 
POKE 737,START HI RETURN 
DCS I RETURN ' 


* 

In this example, the starting address 
is given as STARTLO and STAKTHI, decimal 
numbers that correspond to the low and high 
bytes of the address, respectively. 


SkLfcLT ITEM 




SAVE — GIVE FILE, START, END 
BINFILE/A, 2E0,2E1 ’ 
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L BINARY LOAD 


This selection is used to load into RAM a file already saved with 
BINARY SAVE . 

Exanple: 

SE I fET ITEM <£his exanple loads BINFTEZ. 

L fBKKifSn 

LOAD FRCM WHAT FILE? 

BINFILE I RETORN \ 


M RUN AT AEORESS 

This selection is used to start execution of instructions 

at a given address in hex. 


Exanple: 


) 


SRT.WTT TTEM 
M j RETURN I 


RUN FR OM WHAT ADDRESS? 
RETURN \ 


6000 


L 


This exanple starts execution of instructions 
at address 6000. 


A 
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N DEFINE DEVICE: 


Hie current implementation of this selection has several problems 
and nay or may not be included in future releases of DG6. Users are 

advised not to use this selection until a new version of DCS is released, 
ffcwever, sane examples of use are given in the following description.. 

With this selection sxbbx±bkx±s the user trust specify a logical device 
and a physical device. The specification acts as a definition of the 
logical device. The logical device can be re-defined any nurber of 
times. 


Examples: 


SEL ECT ITEM 
N l RETURN ^ 

LOGICAL DEVICE, PHYSICAL DEVICE 
P: ,TEMP2.P j RETURN \ 


In this exanple, the data sent to the Printer 
are stored in the file TEMP2.P instead 
of being printed. 


SELE CT ITEM 
N r RETOPN 

LOGICAL D EVICE, PH YSICAL DEVICE 
X:,P: { RETURN] 


In this exanple, the imaginary device 
X: is defined to be the Printer. Thus, 
all data referred to X: will be printed. 



a 
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